Skip to content

examples: add .preflight/ starter config with annotated examples#310

Open
TerminalGravity wants to merge 2 commits intomainfrom
examples/add-preflight-config
Open

examples: add .preflight/ starter config with annotated examples#310
TerminalGravity wants to merge 2 commits intomainfrom
examples/add-preflight-config

Conversation

@TerminalGravity
Copy link
Collaborator

The README and examples/README.md both reference examples/.preflight/ but the directory didn't exist — broken link for anyone following the docs.

Adds three annotated example files:

  • config.yml — profile, related projects, thresholds, embedding provider
  • triage.yml — keyword rules, strictness levels, cross-service triggers
  • contracts/api.yml — realistic manual contract definitions (User, route, enum)

All files have detailed inline comments explaining every option so users can copy-paste and customize without reading the full docs.

The interactive setup wizard (npx preflight-dev init) was buried in a
footnote under Option C, despite being the most user-friendly onboarding
path. Moved it to Option A with a clear description of what it does.
Renumbered remaining options accordingly.
The README and examples/README.md both referenced examples/.preflight/
but the directory didn't exist. Adds:
- config.yml — profile, related projects, thresholds, embeddings
- triage.yml — keyword rules, strictness, cross-service triggers
- contracts/api.yml — manual contract definitions with realistic examples

All files have detailed comments explaining every option.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant